9.6.2 Internal archiving
If you want to just switch off (for agenda views) certain
subtrees without moving them to a different file, you can use the
ARCHIVE tag.
A headline that is marked with the ARCHIVE tag (see Tags) stays at its location in the outline
tree, but behaves in the following way:
- It
does not open when you attempt to do so with a visibility
cycling command (see Visibility
cycling). You can force cycling archived subtrees with
C-<TAB>, or by setting the option
org-cycle-open-archived-trees. Also normal outline
commands like show-all will open archived
subtrees.
-
During sparse tree construction (see Sparse trees), matches in
archived subtrees are not exposed, unless you configure the
option
org-sparse-tree-open-archived-trees.
- During
agenda view construction (see Agenda Views), the content
of archived trees is ignored unless you configure the option
org-agenda-skip-archived-trees, in which case
these trees will always be included. In the agenda you can
press v a to get archives temporarily included.
- Archived
trees are not exported (see Exporting), only the headline
is. Configure the details using the variable
org-export-with-archived-trees.
- Archived
trees are excluded from column view unless the variable
org-columns-skip-archived-trees is configured to
nil.
The following commands help manage the ARCHIVE tag:
- C-c C-x a
(
org-toggle-archive-tag)
- Toggle the ARCHIVE tag for the current headline. When the
tag is set, the headline changes to a shadowed face, and the
subtree below it is hidden.
- C-u C-c C-x a
- Check if any direct children of the current headline should
be archived. To do this, each subtree is checked for open TODO
entries. If none are found, the command offers to set the
ARCHIVE tag for the child. If the cursor is not on a
headline when this command is invoked, the level 1 trees will
be checked.
- C-TAB
(
org-force-cycle-archived)
- Cycle a tree even if it is tagged with ARCHIVE.
- C-c C-x A
(
org-archive-to-archive-sibling)
- Move the current entry to the Archive Sibling.
This is a sibling of the entry with the heading
‘Archive’
and the tag ‘ARCHIVE’. The entry becomes a child
of that sibling and in this way retains a lot of its original
context, including inherited tags and approximate position in
the outline.